home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / pd / programmierung / triton / autodocs / triton.doc
Text File  |  1995-08-25  |  41KB  |  1,294 lines
  1. TABLE OF CONTENTS
  2.  
  3. triton.lib/TR_CloseTriton
  4. triton.lib/TR_OpenTriton
  5. triton.library/class_Button
  6. triton.library/class_CheckBox
  7. triton.library/class_Cycle
  8. triton.library/class_DisplayObject
  9. triton.library/class_DropBox
  10. triton.library/class_FrameBox
  11. triton.library/class_Group
  12. triton.library/class_Image
  13. triton.library/class_Line
  14. triton.library/class_Listview
  15. triton.library/class_Object
  16. triton.library/class_Palette
  17. triton.library/class_Progress
  18. triton.library/class_Scroller
  19. triton.library/class_Slider
  20. triton.library/class_Space
  21. triton.library/class_String
  22. triton.library/class_Text
  23. triton.library/TR_AutoRequest
  24. triton.library/TR_CloseProject
  25. triton.library/TR_CloseWindowSafely
  26. triton.library/TR_CreateApp
  27. triton.library/TR_DeleteApp
  28. triton.library/TR_EasyRequest
  29. triton.library/TR_FirstOccurance
  30. triton.library/TR_GetAttribute
  31. triton.library/TR_GetErrorString
  32. triton.library/TR_GetLastError
  33. triton.library/TR_GetMsg
  34. triton.library/TR_LockProject
  35. triton.library/TR_LockScreen
  36. triton.library/TR_NumOccurances
  37. triton.library/TR_ObtainWindow
  38. triton.library/TR_OpenProject
  39. triton.library/TR_ReleaseWindow
  40. triton.library/TR_ReplyMsg
  41. triton.library/TR_SendMessage
  42. triton.library/TR_SetAttribute
  43. triton.library/TR_UnlockProject
  44. triton.library/TR_UnlockScreen
  45. triton.library/TR_Wait
  46. triton.lib/TR_CloseTriton                           triton.lib/TR_CloseTriton
  47.  
  48.    NAME    
  49.     TR_CloseTriton -- Closes Triton easily.
  50.  
  51.    SYNOPSIS
  52.     TR_CloseTriton()
  53.  
  54.     VOID TR_CloseTriton(VOID);
  55.  
  56.    FUNCTION
  57.     Closes the application created by OpenTriton()
  58.     and closes triton.library.
  59.  
  60.    SEE ALSO
  61.     TR_OpenTriton()
  62.  
  63. triton.lib/TR_OpenTriton                             triton.lib/TR_OpenTriton
  64.  
  65.    NAME    
  66.     TR_OpenTriton -- Opens Triton ready to use.
  67.  
  68.    SYNOPSIS
  69.     success = TR_OpenTriton(version, tag1,...)
  70.     D0
  71.  
  72.     BOOL TR_OpenTriton(ULONG, ULONG,...);
  73.  
  74.    FUNCTION
  75.     Opens triton.library with the specified minimum
  76.     version and creates an application.
  77.     The supplied tags are passed as a taglist to
  78.     TR_CreateApp().
  79.  
  80.    RESULT
  81.     success - Was everything opened successful?
  82.  
  83.    SEE ALSO
  84.     TR_CloseTriton(), TR_CreateApp()
  85.  
  86. triton.library/class_Button                       triton.library/class_Button
  87.  
  88.    NAME    
  89.     class_Button -- A BOOPSI button gadget
  90.  
  91.    SUPERCLASS
  92.     class_DisplayObject
  93.  
  94.    SYNOPSIS
  95.     TROB_Button
  96.  
  97.    ATTRIBUTES
  98.     <Default>        : ULONG buttontype
  99.                        - TRBT_TEXT         : Text button (default)
  100.                        - TRBT_GETFILE      : GetFile image button
  101.                        - TRBT_GETDRAWER    : GetDrawer image button
  102.                        - TRBT_GETENTRY     : GetEntry image button
  103.     TRAT_Text        : STRPTR label
  104.     TRAT_Flags       : ULONG flags
  105.                        - TRBU_RETURNOK     : Activated by <Return>
  106.                        - TRBU_ESCOK        : Activated by <Esc>
  107.                        - TRBU_SHIFTED      : Shifted shortcut only
  108.                        - TRBU_UNSHIFTED    : Unshifted shortcut only
  109.                        - TRBU_YRESIZE (V2) : When this flag is set, the
  110.                                              button will be vertically
  111.                                              resizeable. This is required
  112.                                              because beginning with V2
  113.                                              the height of objects which
  114.                                              are normally using the
  115.                                              button height can be
  116.                                              modified in the prefs
  117.                                              editor. Set this flags
  118.                                              WHEREVER POSSIBLE in order
  119.                                              to make buttons adopt to
  120.                                              higher objects in the same
  121.                                              horizontal group.
  122.  
  123. triton.library/class_CheckBox                   triton.library/class_CheckBox
  124.  
  125.    NAME    
  126.     class_CheckBox -- A GadTools checkbox gadget
  127.  
  128.    SUPERCLASS
  129.     class_DisplayObject
  130.  
  131.    SYNOPSIS
  132.     TROB_CheckBox
  133.  
  134.    ATTRIBUTES
  135.     <Default>        : <unused>
  136.     TRAT_Value       : BOOL checked
  137.  
  138. triton.library/class_Cycle                         triton.library/class_Cycle
  139.  
  140.    NAME    
  141.     class_Cycle -- A GadTools cycle gadget
  142.  
  143.    SUPERCLASS
  144.     class_DisplayObject (no attributes inherited)
  145.  
  146.    SYNOPSIS
  147.     TROB_Cycle
  148.  
  149.    ATTRIBUTES
  150.     <Default>        : STRPTR *entries    : Gadget etry labels
  151.                                             (create only)
  152.     TRAT_ID          : ULONG objectid
  153.     TRAT_Value       : ULONG number
  154.     TRAT_Disabled    : BOOL disabled      : Requires OS3.0+ when used
  155.                                             together with TRCY_MX.
  156.     TRAT_Flags       : ULONG flags (V2)
  157.                        - TRCY_MX          : "Unfold" the cycle gadget to
  158.                                             a mutually exclusive gadget.
  159.                        - TRCY_RIGHTLABELS : Put the labels to the right
  160.                                             side (TRCY_MX only).
  161.  
  162.    NOTES
  163.     As of triton.library v4 only TRAT_Value can be queried.
  164.  
  165. triton.library/class_DisplayObject         triton.library/class_DisplayObject
  166.  
  167.    NAME    
  168.     class_DisplayObject -- An abstract display object
  169.  
  170.    SUPERCLASS
  171.     class_Object
  172.  
  173.    SYNOPSIS
  174.     TROB_DisplayObject
  175.  
  176.    ATTRIBUTES
  177.     <Default>            : <unused>
  178.     TRAT_ID              : ULONG objectid
  179.     TRAT_Disabled        : BOOL disabled
  180.     TRDO_QuickHelpString : STRPTR string
  181.  
  182. triton.library/class_DropBox                     triton.library/class_DropBox
  183.  
  184.    NAME    
  185.     class_DropBox -- An icon drop box
  186.  
  187.    SUPERCLASS
  188.     class_DisplayObject
  189.  
  190.    SYNOPSIS
  191.     TROB_DropBox
  192.  
  193.    ATTRIBUTES
  194.     <Default>        : <unused>
  195.  
  196. triton.library/class_FrameBox                   triton.library/class_FrameBox
  197.  
  198.    NAME    
  199.     class_FrameBox -- A framing box
  200.  
  201.    SUPERCLASS
  202.     class_DisplayObject (no attributes inherited)
  203.  
  204.    SYNOPSIS
  205.     TROB_FrameBox
  206.  
  207.    ATTRIBUTES
  208.     <Default>        : ULONG boxtype (V2)
  209.                          If no flag is set, unnamed boxes will
  210.                          be grouping and named ones framing.
  211.                        - TRFB_TEXT       : A text container
  212.                        - TRFB_GROUPING   : A grouping box
  213.                        - TRFB_FRAMING    : A framing box.
  214.     TRAT_ID          : ULONG objectid (V2)
  215.     TRAT_Backfill    : ULONG pattern
  216.     TRAT_Text        : STRPTR label (V2)
  217.     <other>          : <Child object>
  218.  
  219. triton.library/class_Group                         triton.library/class_Group
  220.  
  221.    NAME    
  222.     class_Group -- A grouping object
  223.  
  224.    SUPERCLASS
  225.     class_DisplayObject (no attributes inherited)
  226.  
  227.    SYNOPSIS
  228.     TRGR_Horiz
  229.     TRGR_Vert
  230.  
  231.    ATTRIBUTES
  232.     <Default>        : ULONG flags
  233.                        - TRGR_PROPSHARE  : Divide objects
  234.                                            proportionally
  235.                        - TRGR_EQUALSHARE : Divide objects equally
  236.                        - TRGR_PROPSPACES : Divide spaces
  237.                                            proportionally
  238.                        - TRGR_ARRAY      : Top group of an array. Lines
  239.                                            or culumns can be built
  240.                                            using TRGR_PROPSHARE groups.
  241.                                            At least one group must
  242.                                            be contained in an array.
  243.                        - TRGR_ALIGN      : Align resizeable objects in
  244.                                            their secondary dimension
  245.                        - TRGR_CENTER     : Center non-resizeable
  246.                                            objects in their secondary
  247.                                            dimension
  248.                        - TRGR_FIXHORIZ   : Don't allow horizontal
  249.                                            resizing
  250.                        - TRGR_FIXVERT    : Don't allow vertical
  251.                                            resizing
  252.                        - TRGR_INDEP (V2) : Group is independent of
  253.                                            surrounding array
  254.     TRAT_ID          : ULONG objectid (V4)
  255.     <other>          : <treated as elements of the group>
  256.     TRGR_End         : <unused> : Marks the end of the group
  257.  
  258. triton.library/class_Image                         triton.library/class_Image
  259.  
  260.    NAME    
  261.     class_Image -- An image (V2)
  262.  
  263.    SUPERCLASS
  264.     class_DisplayObject (no attributes inherited)
  265.  
  266.    SYNOPSIS
  267.     TROB_Image
  268.  
  269.    ATTRIBUTES
  270.     <Default>        : <Image>
  271.     TRAT_Flags       : ULONG flags
  272.                        - TRIM_BOOPSI : <Default> is a pointer to a
  273.                                        struct IClass BOOPSI image class.
  274.     TRAT_MinWidth    : Minimum image width in pixels. Defaults to
  275.                        the image button height.
  276.     TRAT_MinHeight   : Minimum image height in pixels. Defaults to
  277.                        the image button height.
  278.     TRAT_ID          : ULONG objectid
  279.  
  280. triton.library/class_Line                           triton.library/class_Line
  281.  
  282.    NAME    
  283.     class_Line -- A 3D line
  284.  
  285.    SUPERCLASS
  286.     class_DisplayObject
  287.  
  288.    SYNOPSIS
  289.     TROB_Line
  290.  
  291.    ATTRIBUTES
  292.     <Default>        : ULONG flags
  293.                        - TROF_HORIZ        : Horizontal line
  294.                                              (Overrides group dimension)
  295.                        - TROF_VERT         : Vertical line
  296.                                              (Overrides group dimension)
  297.                        - TROF_RAISED       : Raised line
  298.  
  299. triton.library/class_Listview                   triton.library/class_Listview
  300.  
  301.    NAME
  302.     class_Listview -- A GadTools Listview gadget
  303.  
  304.    SUPERCLASS
  305.     class_DisplayObject (no attributes inherited)
  306.  
  307.    SYNOPSIS
  308.     TROB_Listview
  309.  
  310.    ATTRIBUTES
  311.     <Default>        : struct List *entries
  312.     TRAT_ID          : ULONG objectid
  313.     TRAT_Disabled    : BOOL disabled
  314.     TRAT_Flags       : ULONG flags
  315.                        - Listview type (mutually exclusive):
  316.                          - TRLV_READONLY     : A read-only list
  317.                          - TRLV_SELECT       : You may select an entry
  318.                          - TRLV_SHOWSELECTED : Show selected entry
  319.                        - TRLV_NOCURSORKEYS   : Don't use arrow keys
  320.                        - TRLV_NONUMPADKEYS   : Don't use keypad keys
  321.                        - TRLV_FWFONT         : Use the fixed-width font
  322.                        - TRLV_NOGAP (V2)     : Leave no gap below the
  323.                                                list but instead at the
  324.                                                end of the group.
  325.     TRAT_Value       : ULONG selected        : Currently selected entry
  326.                                                (TRLV_SHOWSELECTED only)
  327.     TRLV_Top         : ULONG top
  328.     TRAT_MinWidth    : ULONG minwidth        : Minimum width
  329.                                                (Default: 10 characters)
  330.     TRAT_MinHeight   : ULONG minheight       : Minimum height
  331.                                                (Default: 4 lines)
  332.  
  333.    MESSAGES
  334.     'Select' listviews send TRMS_ACTION messages. 'ShowSelected' lists
  335.     send TRMS_NEWVALUE messages. trm_Data contains the ordinal number
  336.     of the selected entry. trm_Qualifier&IEQUALIFIER_REPEAT is set if
  337.     the user has double-clicked the specified listview entry.
  338.  
  339.    NOTES
  340.     As of triton.library v4 only TRAT_Value can be queried.
  341.  
  342.    BUGS
  343.     In triton.library v2 the fixed-width font handling was broken.
  344.  
  345. triton.library/class_Object                       triton.library/class_Object
  346.  
  347.    NAME    
  348.     class_Object -- The abstract root class
  349.  
  350.    SUPERCLASS
  351.     <none>
  352.  
  353.    SYNOPSIS
  354.     TROB_Object
  355.  
  356.    ATTRIBUTES
  357.     <Default>        : <unused>
  358.  
  359. triton.library/class_Palette                     triton.library/class_Palette
  360.  
  361.    NAME    
  362.     class_Palette -- A GadTools palette gadget
  363.  
  364.    SUPERCLASS
  365.     class_DisplayObject
  366.  
  367.    SYNOPSIS
  368.     TROB_Palette
  369.  
  370.    ATTRIBUTES
  371.     <Default>        : <unused>
  372.     TRAT_Value       : BOOL checked
  373.  
  374. triton.library/class_Progress                   triton.library/class_Progress
  375.  
  376.    NAME    
  377.     class_Progress -- A progress indicator
  378.  
  379.    SUPERCLASS
  380.     class_DisplayObject (no attributes inherited)
  381.  
  382.    SYNOPSIS
  383.     TROB_Progress
  384.  
  385.    ATTRIBUTES
  386.     <Default>        : ULONG maximum
  387.     TRAT_Flags       : ULONG orientation
  388.                        - TROF_HORIZ (default)
  389.                        - TROF_VERT
  390.     TRAT_ID          : ULONG objectid
  391.     TRAT_Value       : ULONG current
  392.  
  393. triton.library/class_Scroller                   triton.library/class_Scroller
  394.  
  395.    NAME    
  396.     class_Scroller -- A GadTools scroller gadget
  397.  
  398.    SUPERCLASS
  399.     class_DisplayObject (no attributes inherited)
  400.  
  401.    SYNOPSIS
  402.     TROB_Scroller
  403.  
  404.    ATTRIBUTES
  405.     <Default>        : ULONG flags
  406.                        - TROF_HORIZ        : Horizontal scroller
  407.                        - TROF_VERT         : Vertical scroller
  408.     TRAT_ID          : ULONG objectid
  409.     TRAT_Value       : WORD top
  410.     TRAT_Disabled    : BOOL disabled
  411.     TRSC_Total       : WORD total
  412.     TRSC_Visible     : WORD visible
  413.  
  414. triton.library/class_Slider                       triton.library/class_Slider
  415.  
  416.    NAME    
  417.     class_Slider -- A GadTools slider gadget
  418.  
  419.    SUPERCLASS
  420.     class_DisplayObject (no attributes inherited)
  421.  
  422.    SYNOPSIS
  423.     TROB_Slider
  424.  
  425.    ATTRIBUTES
  426.     <Default>        : ULONG flags
  427.                        - TROF_HORIZ (default)
  428.                        - TROF_VERT
  429.     TRAT_ID          : ULONG objectid
  430.     TRAT_Value       : WORD level
  431.     TRAT_Disabled    : BOOL disabled
  432.     TRSL_Min         : WORD min
  433.     TRSL_Max         : WORD max
  434.  
  435. triton.library/class_Space                         triton.library/class_Space
  436.  
  437.    NAME    
  438.     class_Space -- A class of spaces with various sizes
  439.  
  440.    SUPERCLASS
  441.     class_DisplayObject
  442.  
  443.    SYNOPSIS
  444.     TROB_Space
  445.  
  446.    ATTRIBUTES
  447.     <Default>        : ULONG spacetype
  448.                        - TRST_NONE         : No space
  449.                        - TRST_SMALL        : Small space
  450.                        - TRST_NORMAL       : Normal space (default)
  451.                        - TRST_BIG          : Big space
  452.  
  453. triton.library/class_String                       triton.library/class_String
  454.  
  455.    NAME    
  456.     class_String -- A GadTools string gadget
  457.  
  458.    SUPERCLASS
  459.     class_DisplayObject (no attributes inherited)
  460.  
  461.    SYNOPSIS
  462.     TROB_String
  463.  
  464.    ATTRIBUTES
  465.     <Default>        : STRPTR string
  466.     TRAT_ID          : ULONG objectid
  467.     TRAT_Disabled    : BOOL disabled
  468.     TRAT_Value       : UWORD maxchars (default: 64)
  469.                        [create only]
  470.     TRAT_Flags       : ULONG flags
  471.                        - TRST_INVISIBLE         : Invisible typing
  472.                        - TRST_NORETURNBROADCAST : Don't broadcast <Return>
  473.                                                   key presses to the window.
  474.                        [create only]
  475.  
  476.    OBJECT MESSAGES
  477.     TROM_ACTIVATE    : Activate the string gadget.
  478.  
  479. triton.library/class_Text                           triton.library/class_Text
  480.  
  481.    NAME    
  482.     class_Text -- A line of text / A value
  483.  
  484.    SUPERCLASS
  485.     class_DisplayObject (no attributes inherited)
  486.  
  487.    SYNOPSIS
  488.     TROB_Text
  489.  
  490.    ATTRIBUTES
  491.     <Default>        : <unused>
  492.     TRAT_ID          : ULONG objectid
  493.     TRAT_Text        : STRPTR text
  494.     TRAT_Value       : ULONG number
  495.     TRAT_MinWidth    : ULONG number_of_average_chars
  496.     TRAT_Flags       : ULONG flags
  497.                        - TRTX_NOUNDERSCORE    : Don't interpret underscores
  498.                        - TRTX_HIGHLIGHT       : Highlight text
  499.                        - TRTX_3D              : Highlight with shadows
  500.                        - TRTX_BOLD            : Bold text
  501.                        - TRTX_TITLE           : Use this for titles (e.g.
  502.                                                 of separator bars).
  503.                        - TROF_RIGHTALIGN (V2) : Align text to the right border
  504.                                                 of available space (e.g. in
  505.                                                 text boxes and arrays)
  506.                        - TRTX_CLIPPED (V4)    : Text is resizable in X
  507.                                                 direction. Text which
  508.                                                 exceeds the available
  509.                                                 space will be truncated.
  510.  
  511.    BUGS
  512.     Below v2 of triton.library changing TRAT_Text while the text was
  513.     displayed did only work with text on a TRBF_WINDOWBACK object.
  514.  
  515. triton.library/TR_AutoRequest                   triton.library/TR_AutoRequest
  516.  
  517.    NAME    
  518.     TR_AutoRequest -- A (relatively ;-) low-level requester function.
  519.  
  520.    SYNOPSIS
  521.     selection = TR_AutoRequest(App, Project, TagList)
  522.     D0                         A1   A0       A2
  523.  
  524.     ULONG TR_AutoRequest(struct TR_App *, struct TR_Project *,
  525.                          struct AppItem *);
  526.  
  527.     selection = TR_AutoRequestTags(App, Project, Tag,...)
  528.     D0
  529.  
  530.     ULONG TR_AutoRequestTags(struct TR_App *, struct TR_Project *,
  531.                          struct AppItem *);
  532.  
  533.    FUNCTION
  534.     Pops up a requester which is described by the supplied tag list.
  535.     As soon as a TRMS_ACTION message is sent by one of the objects,
  536.     the requester will close. If a project is supplied, it will be
  537.     locked when opening the requester and unlocked when closing it.
  538.  
  539.    RESULT
  540.     selection - The ID of the object which triggered the action,
  541.                 NULL for an error, (ULONG)(-1) for the close gadget.
  542.  
  543.    NOTES
  544.     Simple requesters with just text and buttons can be done easier
  545.     with TR_EasyRequest(). If you need more complex requesters, you
  546.     have to use your own message polling loop instead of
  547.     TR_AutoRequest(). You may still use the requester macros though.
  548.  
  549.    SEE ALSO
  550.     TR_EasyRequest()
  551.  
  552. triton.library/TR_CloseProject                 triton.library/TR_CloseProject
  553.  
  554.    NAME    
  555.     TR_CloseProject -- Closes a project/window.
  556.  
  557.    SYNOPSIS
  558.     TR_CloseProject(Project)
  559.                     A0
  560.  
  561.     VOID TR_CloseProject(struct TR_Project *);
  562.  
  563.    FUNCTION
  564.     Closes a Triton project.
  565.  
  566.    SEE ALSO
  567.     TR_OpenProject()
  568.  
  569. triton.library/TR_CloseWindowSafely       triton.library/TR_CloseWindowSafely
  570.  
  571.    NAME    
  572.     TR_CloseWindowSafely -- Closes as window with a shared IDCMP port.
  573.  
  574.    SYNOPSIS
  575.     TR_CloseWindowSafely(Window)
  576.                          A0
  577.  
  578.     VOID TR_CloseWindowSafely(struct Window *);
  579.  
  580.    FUNCTION
  581.     Closes a window which shares its IDCMP port with another window.
  582.     All the pending messages (concerning this window) on the port
  583.     will be removed and the window will be closed.
  584.     
  585.     Do *NOT* use this function to close windows which have an IDCMP
  586.     port set up by Intuition. If you do the port will be left in memory!
  587.     
  588.     If you intend to open a lot of windows all sharing the same IDCMP
  589.     port it is easiest if you create a port yourself and open all
  590.     windows with newwin.IDCMPFlags set to 0 (this tells Intuition NOT to
  591.     set up an IDCMP port). After opening the window set win->UserPort
  592.     to your message port and call ModifyIDCMP() to set your IDCMP flags.
  593.     
  594.     When you then receive messages from Intuition check their
  595.     imsg->IDCMPWindow field to find out what window they came from
  596.     and act upon them.
  597.     
  598.     When closing your windows call TR_CloseWindowSafely() for all of
  599.     them and delete your message port.
  600.  
  601.    INPUTS
  602.     Window - pointer to the window to be closed.
  603.  
  604.    NOTE
  605.     This function is for the advanced Triton user.
  606.  
  607.    SEE ALSO
  608.     intuition.library/CloseWindow()
  609.  
  610. triton.library/TR_CreateApp                       triton.library/TR_CreateApp
  611.  
  612.    NAME    
  613.     TR_CreateApp -- Creates a Triton application.
  614.     TR_CreateAppTags -- Varargs stub for TR_CreateApp.
  615.  
  616.    SYNOPSIS
  617.     app = TR_CreateApp(TagList)
  618.     D0                 A1
  619.  
  620.     struct TR_App * TR_CreateApp(struct TagItem *);
  621.  
  622.     app = TR_CreateAppTags(Tag1,...)
  623.  
  624.     struct TR_App * TR_CreateApp(ULONG,...);
  625.  
  626.    FUNCTION
  627.     Creates an application. An application is required
  628.     for opening windows and polling messages. All projects
  629.     of an application will share one IDCMP port and one
  630.     memory pool.
  631.  
  632.    TAGS
  633.     TRCA_Name        - (STRPTR)
  634.                        Unique name for the application. Must not be
  635.                        longer than 20 characters. Case-insensitive.
  636.                        ' ', '/', '.' and ':' are not allowed.
  637.     TRCA_LongName    - (STRPTR)
  638.                        A user-readable name for the application.
  639.                        Up to 60 characters allowed.
  640.     TRCA_Info        - (STRPTR)
  641.                        Information about the application. Should not
  642.                        be more than 2 lines with 60 characters each.
  643.     TRCA_Version     - (STRPTR)
  644.                        Internal version of the application.
  645.     TRCA_Release     - (STRPTR)
  646.                        Release number of the application.
  647.     TRCA_Date        - (STRPTR)
  648.                        Creation/compilation date. Should be given
  649.                        in standard version string format.
  650.     
  651.     Example:
  652.       Name        : DilloCreate
  653.       LongName    : Armadillo Creator
  654.       Info        : Part of the Armadillo Management System.
  655.                     © 1994 by DilloWorks Enterprises.
  656.       Version     : 42.135
  657.       Release     : 2.1bß3
  658.       Date        : 17.6.94
  659.  
  660.    RESULT
  661.     app - A pointer to the created application structure.
  662.           NULL indicates failure.
  663.  
  664.    SEE ALSO
  665.     TR_DeleteApp()
  666.  
  667. triton.library/TR_DeleteApp                       triton.library/TR_DeleteApp
  668.  
  669.    NAME    
  670.     TR_DeleteApp -- Deletes a Triton application.
  671.  
  672.    SYNOPSIS
  673.     TR_DeleteApp(App)
  674.                  A1
  675.  
  676.     VOID TR_DeleteApp(struct TR_App *);
  677.  
  678.    FUNCTION
  679.     Deletes an application created by TR_CreateApp().
  680.  
  681.    NOTES
  682.     All windows have to be closed before deleting the
  683.     corresponding application!
  684.  
  685.    SEE ALSO
  686.     TR_CreateApp()
  687.  
  688. triton.library/TR_EasyRequest                   triton.library/TR_EasyRequest
  689.  
  690.    NAME    
  691.     TR_EasyRequest -- A high-level requester function.
  692.  
  693.    SYNOPSIS
  694.     selection = TR_EasyRequest(App, BodyFmt, GadFmt, TagList)
  695.     D0                         A1   A2       A3      A0
  696.  
  697.     ULONG TR_EasyRequest(struct TR_App *, STRPTR, STRPTR, struct TagItem *);
  698.  
  699.     selection = TR_EasyRequestTags(App, BodyFmt, GadFmt, Tag,...)
  700.     D0
  701.  
  702.     ULONG TR_EasyRequestTags(struct TR_App *, STRPTR, STRPTR, ULONG,...);
  703.  
  704.    FUNCTION
  705.     Pops up a requester and waits for the user to select a gadget.
  706.  
  707.    INPUTS
  708.     App       - A valid Triton application.
  709.     BodyFmt   - A formatted text which will be displayed in the
  710.                 requester body. A <newline> (\n) will start a new line
  711.                 with a small space above it. A <return> (\r) will add
  712.                 a normal space instead. A <tab> (\t) will add a normal
  713.                 space, then a 3D separator line and again a normal
  714.                 space. '%b' will switch to boldface, '%3' to 3D text,
  715.                 '%h' to highlight and '%n' to normal style (at the moment
  716.                 styles may only be changed at the beginning of a line!).
  717.                 Beginning with v2, '%s' ('Shadow') is allowed as an alias
  718.                 for '%3' because CatComp doesn't compile catalogs with
  719.                 '%3' in the description files.
  720.                 (Sigh, why is there no way of telling CatComp not to
  721.                 interpret '%' characters...)
  722.     GadFmt    - The gadget texts, separated by '|'.
  723.     TagList   - Pointer to a TagItem array.
  724.  
  725.    TAGS
  726.     TREZ_ReqPos      - (ULONG)
  727.                        The requester's position (TRWP_...).
  728.                        The default is TRWP_MOUSEPOINTER.
  729.     TREZ_LockProject - (struct TR_Project *)
  730.                        This project will be locked while the
  731.                        requester is displayed. Information about
  732.                        screen and activity state of the requester
  733.                        are taken from this project.
  734.     TREZ_Return      - (ULONG)
  735.                        Number of the default gadget which can be
  736.                        activated by <RETURN>. Defaults to 1 (0 in
  737.                        a single-gadget requester).
  738.     TREZ_Title       - (STRPTR)
  739.                        Requester window title. Default is
  740.                        "System request" (or a localized version under
  741.                        OS2.1 and higher).
  742.     TREZ_Activate    - (BOOL)
  743.                        If this tag is supplied, the activity state
  744.                        of the requester window will be taken from
  745.                        this tag's argument instead of being inherited
  746.                        from the locked project (if applicable).
  747.  
  748.    RESULT
  749.     selection - The number of the selected gadget. The gadgets are
  750.                 numbered from left to right beginning with 1. The
  751.                 rightmost gadget (or the only gadget in a 1-gadget
  752.                 requester) has got number 0. (ULONG)(-1) is returned
  753.                 for indicating an error.
  754.  
  755.    SEE ALSO
  756.     TR_AutoRequest()
  757.  
  758. triton.library/TR_FirstOccurance             triton.library/TR_FirstOccurance
  759.  
  760.    NAME    
  761.     TR_FirstOccurance -- Finds a character in a string.
  762.  
  763.    SYNOPSIS
  764.     Position = TR_FirstOccurance(Character, String)
  765.     D0                           D0         A0
  766.  
  767.     LONG TR_FirstOccurance(UBYTE, STRPTR);
  768.  
  769.    FUNCTION
  770.     Finds the specified character in the string.
  771.  
  772.    RESULT
  773.     Position - The position of the first occurance of the
  774.     character in the string or -1 if the character couldn't
  775.     be found in the string.
  776.  
  777. triton.library/TR_GetAttribute                 triton.library/TR_GetAttribute
  778.  
  779.    NAME    
  780.     TR_GetAttribute -- Gets an attribute of an object.
  781.  
  782.    SYNOPSIS
  783.     value = TR_GetAttribute(Project, ID, Attribute)
  784.     D0                      A0       D0  D1
  785.  
  786.     ULONG TR_GetAttribute(struct TR_Project *, ULONG,
  787.                           ULONG);
  788.  
  789.    FUNCTION
  790.     Gets an attribute of a Triton object. Only attributes
  791.     of objects with an ID can be queried.
  792.  
  793.    RESULT
  794.     value - Value of the specified attribute. Depends
  795.             on specific class and attribute.
  796.  
  797.    SEE ALSO
  798.     Class descriptions, TR_SetAttribute()
  799.  
  800. triton.library/TR_GetErrorString             triton.library/TR_GetErrorString
  801.  
  802.    NAME    
  803.     TR_GetErrorString -- Creates an error message
  804.  
  805.    SYNOPSIS
  806.     Message = TR_GetErrorString(Number)
  807.     D0                          D0
  808.  
  809.     STRPTR TR_GetErrorString(UWORD);
  810.  
  811.    FUNCTION
  812.     Creates an error message which matches the supplied
  813.     Triton error code.
  814.  
  815.    INPUTS
  816.     Number - Triton error code. In most cases you will
  817.              get this with TR_GetLastError().
  818.  
  819.    RESULT
  820.     Message - Pointer to a user-readable error message
  821.               or an empty string ("") if none available.
  822.  
  823.    BUGS
  824.     In older Triton versions, TR_GetErrorString() did
  825.     return NULL instead of an empty string. This is
  826.     fixed in V4.
  827.  
  828.    SEE ALSO
  829.     TR_GetLastError()
  830.  
  831. triton.library/TR_GetLastError                 triton.library/TR_GetLastError
  832.  
  833.    NAME    
  834.     TR_GetLastError -- Gets the last error code
  835.  
  836.    SYNOPSIS
  837.     Number = TR_GetLastError(App)
  838.     D0                       A1
  839.  
  840.     UWORD TR_GetLastError(struct TR_App *);
  841.  
  842.    FUNCTION
  843.     Returns the TRER code of the last error which occured
  844.     in the application and sets the internal tra_LastError
  845.     back to TRER_OK.
  846.  
  847.    INPUTS
  848.     App - Pointer to a Triton Application
  849.  
  850.    RESULT
  851.     Number - TRER error code
  852.  
  853.    SEE ALSO
  854.     TR_GetErrorString()
  855.  
  856. triton.library/TR_GetMsg                             triton.library/TR_GetMsg
  857.  
  858.    NAME    
  859.     TR_GetMsg -- Gets a Triton message.
  860.  
  861.    SYNOPSIS
  862.     message = TR_GetMsg(App)
  863.     D0                  A1
  864.  
  865.     struct TR_Message * TR_GetMsg(struct TR_App *);
  866.  
  867.    FUNCTION
  868.     Gets a message from a Triton application created
  869.     by TR_CreateApp(). You may first want to wait for
  870.     a message with TR_Wait().
  871.  
  872.    NOTES
  873.     Please reply all messages as quickly as possible
  874.     with TR_ReplyMsg(). This will reduce memory usage.
  875.     All pending messages will be freed automatically when
  876.     you shut down the application with TR_DeleteApp().
  877.     It is *NOT* guaranteed that all reserved resources
  878.     *within* the messages will be freed (like AppMessages)!
  879.  
  880.    SEE ALSO
  881.     TR_ReplyMsg(), TR_Wait()
  882.  
  883. triton.library/TR_LockProject                   triton.library/TR_LockProject
  884.  
  885.    NAME    
  886.     TR_LockProject -- Locks a Triton project.
  887.  
  888.    SYNOPSIS
  889.     TR_LockProject(Project)
  890.                    A0
  891.  
  892.     VOID TR_LockProject(struct TR_Project *);
  893.  
  894.    FUNCTION
  895.     Locks a Triton project. Only window resizing will
  896.     still work in a locked project. All other kinds of
  897.     input (i.e. all input which requires interaction
  898.     by your program and not only by Triton) are not
  899.     possible.
  900.  
  901.    SEE ALSO
  902.     TR_UnlockProject()
  903.  
  904. triton.library/TR_LockScreen                     triton.library/TR_LockScreen
  905.  
  906.    NAME    
  907.     TR_LockScreen -- Get a project's screen
  908.  
  909.    SYNOPSIS
  910.     screen = TR_LockScreen(Project)
  911.     D0                     A0
  912.  
  913.     struct Screen * TR_LockScreen(struct TR_Project *);
  914.  
  915.    FUNCTION
  916.     Lock the screen of a Triton project for use with non-Triton
  917.     windows (e.g. for opening a file requester on the screen of a
  918.     Triton application). The screen must be unlocked later with
  919.     TR_UnlockScreen(). Locking/unlocking calls are nested.
  920.  
  921.    RESULT
  922.     screen - Pointer to the project's screen or NULL to indicate an
  923.              error. In this case the application should *not* abort,
  924.              but *quietly* use another screen (preferably the
  925.              Workbench screen) instead.
  926.  
  927.    SEE ALSO
  928.     TR_UnlockScreen()
  929.  
  930. triton.library/TR_NumOccurances               triton.library/TR_NumOccurances
  931.  
  932.    NAME    
  933.     TR_NumOccurances -- Counts a character in a string.
  934.  
  935.    SYNOPSIS
  936.     Number = TR_NumOccurances(Character, String)
  937.     D0                        D0         A0
  938.  
  939.     LONG TR_NumOccurances(UBYTE, STRPTR);
  940.  
  941.    FUNCTION
  942.     Counts the number of occurances of the character in the string.
  943.  
  944.    RESULT
  945.     Number - The number of occurances found.
  946.  
  947. triton.library/TR_ObtainWindow                 triton.library/TR_ObtainWindow
  948.  
  949.    NAME    
  950.     TR_ObtainWindow -- Get a project's window. (V3)
  951.  
  952.    SYNOPSIS
  953.     window = TR_ObtainWindow(Project)
  954.     D0                       A0
  955.  
  956.     struct Window * TR_ObtainWindow(struct TR_Project *);
  957.  
  958.    FUNCTION
  959.     Lock the window of a Triton project for non-Triton window
  960.     operations (e.g. activating a window or bringing it to the
  961.     front). Do not manipulate the contents of Triton windows!
  962.     Locked windows must be freed again with TR_UnlockWindow().
  963.     Locking/unlocking calls are nested.
  964.  
  965.    RESULT
  966.     window - Pointer to the project's Window. A value of NULL should
  967.              be quietly ignored. NULL simply indicates that there is
  968.              currently no window available.
  969.  
  970.    SEE ALSO
  971.     TR_UnlockWindow()
  972.  
  973. triton.library/TR_OpenProject                   triton.library/TR_OpenProject
  974.  
  975.    NAME    
  976.     TR_OpenProject -- Opens a project/window.
  977.     TR_OpenProjectTags -- Varargs stub for TR_OpenProject.
  978.  
  979.    SYNOPSIS
  980.     Project = TR_OpenProject(App, TagItems)
  981.     D0                       A1   A0
  982.  
  983.     struct TR_Project *TR_OpenProject(struct TR_App *,
  984.                                       struct TagItem *);
  985.  
  986.     Project = TR_OpenProjectTags(App, Tag1,...)
  987.  
  988.     struct TR_Project *TR_OpenProjectTags(struct TR_App *,
  989.                                           ULONG,...);
  990.  
  991.    FUNCTION
  992.     Opens a Triton project. The supplied taglist may contain
  993.     window tags, menu tags and object tags (in that order).
  994.     Mutually exclusive menus are not yet supported. When creating
  995.     a menu item with an ID, TRAT_ID must be the *last* tag.
  996.     A valid application pointer must be supplied.
  997.  
  998.    INPUTS
  999.     App = Valid application pointer
  1000.     TagItems = List of tags describing the project
  1001.  
  1002.    TAGS
  1003.     The taglist may contain window tags, menu tags and object tags
  1004.     (in that order!). The following list shows the window and menu
  1005.     tags. See the class descriptions for the object tags.
  1006.  
  1007.     TRWI_Title (STRPTR) - The window title (changeable)
  1008.  
  1009.     TRWI_ScreenTitle (STRPTR) - The screen title (changeable) (V2)
  1010.  
  1011.     TRWI_Flags (ULONG) - The Triton window flags:
  1012.     - TRWF_BACKDROP        : Create a backdrop borderless window
  1013.                              in full screen size
  1014.     - TRWF_NODRAGBAR       : No dragging bar
  1015.     - TRWF_NODEPTHGADGET   : No depth arranging gadget
  1016.     - TRWF_NOCLOSEGADGET   : No close gadget
  1017.     - TRWF_NOACTIVATE      : Don't activate window
  1018.     - TRWF_NOESCCLOSE      : Don't send TRMS_CLOSEWINDOW when
  1019.                              Esc is pressed
  1020.     - TRWF_NOPSCRFALLBACK  : Don't fall back onto default PubScreen
  1021.     - TRWF_NOZIPGADGET     : No zip/zoom gadget
  1022.     - TRWF_ZIPCENTERTOP    : Center zipped window on screen title bar
  1023.     - TRWF_NOMINTEXTWIDTH  : Window title text length doesn't count
  1024.                              for window size calculation
  1025.     - TRWF_NOSIZEGADGET    : No size gadget
  1026.     - TRWF_NOFONTFALLBACK  : Don't fall back to topaz/8
  1027.     - TRWF_NODELZIP        : Don't zip the window when Del is pressed
  1028.     - TRWF_SIMPLEREFRESH   : Use simple instead of smart refresh. (V1)
  1029.                              This flag is *obsolete* in V3+!
  1030.                              The refresh type is now set by the user.
  1031.     - TRWF_ZIPTOCURRENTPOS : Zip the window without changing its
  1032.                              position. Requires OS3.0 or higher.
  1033.     - TRWF_APPWINDOW       : Create an AppWindow even if no object
  1034.                              reacts on dropped icons
  1035.     - TRWF_ACTIVATESTRGAD  : Activate the first string gadget after
  1036.                              opening the window
  1037.     - TRWF_HELP            : When the user presses <Help> over a menu
  1038.                              item or a display object, a TRMS_HELP
  1039.                              message will be sent (V2)
  1040.     - TRWF_SYSTEMACTION    : When a system action IDCMP message arrives,
  1041.                              a corresponding Triton message will be
  1042.                              generated. These are currently
  1043.                              TRMS_DISKINSERTED and TRMS_DISKREMOVED.
  1044.                              (V4)
  1045.  
  1046.     TRWI_Underscore (UBYTE *) - The underscore for menu and gadget
  1047.         shortcuts. The default is "_".
  1048.  
  1049.     TRWI_Position (ULONG) - The window position:
  1050.     - TRWP_DEFAULT         : Let Triton choose a good position for
  1051.                              the window
  1052.     - TRWP_BELOWTITLEBAR   : Left side of screen; below the title bar
  1053.     - TRWP_CENTERTOP       : Top of screen; centered on the title bar
  1054.     - TRWP_TOPLEFTSCREEN   : Top left corner of screen
  1055.     - TRWP_CENTERSCREEN    : Centered on the screen
  1056.     - TRWP_CENTERDISPLAY   : Centered on the currently displayed clip
  1057.     - TRWP_MOUSEPOINTER    : Centered under the mouse pointer
  1058.  
  1059.     TRWI_CustomScreen (struct Screen *) - A custom screen on which
  1060.         the window will be opened
  1061.  
  1062.     TRWI_PubScreen (struct Screen *) - A public screen on which the
  1063.         window will be opened. The screen *must* have been locked.
  1064.  
  1065.     TRWI_PubScreenName (STRPTR) - A public screen on which the window
  1066.         will be opened. Triton will try to lock the screen with the
  1067.         specified name. It will fall back onto the default public
  1068.         screen in case the screen can't be found/locked if you don't
  1069.         specify TRWF_NOPSCRFALLBACK.
  1070.  
  1071.     TRWI_PropFontAttr (struct TextAttr *) - The proportional font. If
  1072.         Triton can't open the font or the window would become too big
  1073.         for the screen with this font and you didn't specify
  1074.         TRWF_NOFONTFALLBACK, Triton will try to use topaz/8 instead.
  1075.  
  1076.     TRWI_FixedWidthFontAttr (struct TextAttr *) - The fixed-width
  1077.         font. If Triton can't open the font or the window would
  1078.         become too big for the screen with this font and you didn't
  1079.         specify TRWF_NOFONTFALLBACK, Triton will try to use topaz/8
  1080.         instead.
  1081.  
  1082.     TRWI_Backfill (ULONG) - The backfill type:
  1083.     - TRBF_WINDOWBACK        : Default window background; Can be
  1084.                                changed by the user in the Triton
  1085.                                Preferences editor
  1086.     - TRBF_REQUESTERBACK     : Default requester background; Can be
  1087.                                changed by the user in the Triton
  1088.                                Preferences editor
  1089.     - TRBF_NONE              : No backfill (i.e. fill with
  1090.                                BACKGROUNDPEN)
  1091.     - TRBF_SHINE             : Fill with SHINEPEN
  1092.     - TRBF_SHADOW            : Fill with SHADOWPEN
  1093.     - TRBF_FILL              : Fill with FILLPEN
  1094.     - TRBF_SHINE_SHADOW      : Fill with a pattern composed of
  1095.                                SHINEPEN and SHADOWPEN
  1096.     - TRBF_SHINE_FILL        : ~ SHINEPEN and FILLPEN
  1097.     - TRBF_SHINE_BACKGROUND  : ~ SHINEPEN and BACKGROUNDPEN
  1098.     - TRBF_SHADOW_FILL       : ~ SHADOWPEN and FILLPEN
  1099.     - TRBF_SHADOW_BACKGROUND : ~ SHADOWPEN and BACKGROUNDPEN
  1100.     - TRBF_FILL_BACKGROUND   : ~ FILLPEN and BACKGROUNDPEN
  1101.  
  1102.     TRWI_ID (ULONG) - An ID for the window. Identical windows (e.g.
  1103.         several identical data editor windows) should share the same
  1104.         ID. Different applications may share the same IDs.
  1105.  
  1106.     TRWI_Dimensions (struct TR_Dimensions *) - A window dimension
  1107.         structure. The user program must supply a structure on its
  1108.         own if it wants to use this feature. Triton will *not*
  1109.         allocate it. If you use a dimensions structure, Triton will
  1110.         copy the window dimensions into it when you close the window.
  1111.         If you supply a filled-in dimension structure, Triton will try
  1112.         to open the window with these dimensions. Supply an empty
  1113.         structure if you want Triton to use the default dimensions (the
  1114.         position may then be specified with TRWI_Position) and fill
  1115.         in the structure for later use.
  1116.  
  1117.     TRWI_QuickHelp (BOOL) - When this flag is set, QuickHelp windows
  1118.         will pop up for those objects which have QuickHelp strings
  1119.         assigned to them. (changeable) (V4)
  1120.  
  1121.     TRMN_Title (STRPTR) - A menu label
  1122.  
  1123.     TRMN_Item (STRPTR) - A menu item label. You may attach a
  1124.         keyboard shortcut to a menu by starting the label string
  1125.         with the shortcut followed by the project's underscore
  1126.         character and then the actual label. You may also use
  1127.         extended menu shortcuts composed of more than one character.
  1128.         Extended shortcuts can be specified with an underscore at
  1129.         the beginning, then the shortcut, again an underscore and
  1130.         the label. You may specify TRMN_BARLABEL instead of a string
  1131.         to create a separator bar in the menu.
  1132.  
  1133.     TRMN_Sub (STRPTR) - A sub-menu item label. See TRMN_Item.
  1134.  
  1135.     TRMN_Flags (ULONG) - Flags for a menu item:
  1136.     - TRMF_CHECKIT         : The menu item may be checked.
  1137.     - TRMF_CHECKED         : The menu item is checked. You may, but
  1138.                              you do not need to specify TRMF_CHECKIT
  1139.                              in addition.
  1140.     - TRMF_DISABLED        : The menu / (sub) item will be ghosted.
  1141.  
  1142.    RESULT
  1143.     Project - The pointer to the TR_Project structure
  1144.  
  1145.    SEE ALSO
  1146.     TR_CloseProject()
  1147.  
  1148. triton.library/TR_ReleaseWindow               triton.library/TR_ReleaseWindow
  1149.  
  1150.    NAME    
  1151.     TR_ReleaseWindow -- Release a project's window. (V3)
  1152.  
  1153.    SYNOPSIS
  1154.     TR_ReleaseWindow(Window)
  1155.                     A0
  1156.  
  1157.     VOID TR_ReleaseWindow(struct Window *);
  1158.  
  1159.    FUNCTION
  1160.     Unlock a window which has been locked by TR_ObtainWindow(). All
  1161.     locked windows must be unlocked! Locking/unlocking calls are
  1162.     nested.
  1163.  
  1164.    SEE ALSO
  1165.     TR_ObtainWindow()
  1166.  
  1167. triton.library/TR_ReplyMsg                         triton.library/TR_ReplyMsg
  1168.  
  1169.    NAME    
  1170.     TR_ReplyMsg -- Replies a Triton message.
  1171.  
  1172.    SYNOPSIS
  1173.     TR_ReplyMsg(Message)
  1174.                 A1
  1175.  
  1176.     VOID TR_ReplyMsg(struct TR_Message *);
  1177.  
  1178.    FUNCTION
  1179.     Replies a message allocated by TR_GetMsg().
  1180.  
  1181.    NOTES
  1182.     Please reply all messages as quickly as possible
  1183.     with TR_ReplyMsg(). This will reduce memory usage.
  1184.     All pending messages will be freed automatically when
  1185.     you shut down the application with TR_DeleteApp().
  1186.     It is *NOT* guaranteed that all reserved resources
  1187.     *within* the messages will be freed (like AppMessages)!
  1188.  
  1189.    SEE ALSO
  1190.     TR_GetMsg(), TR_Wait()
  1191.  
  1192. triton.library/TR_SendMessage                   triton.library/TR_SendMessage
  1193.  
  1194.    NAME    
  1195.     TR_SendMessage -- Send a message to one or more objects. (V4)
  1196.  
  1197.    SYNOPSIS
  1198.     TR_SendMessage(Project, ID, MessageID, MessageData)
  1199.                    A0       D0  D1         A1
  1200.  
  1201.     ULONG TR_SendMessage(struct TR_Project *, ULONG,
  1202.                          ULONG, void *);
  1203.  
  1204.    FUNCTION
  1205.     Sends an object message, specified by its ID (TROM_...)
  1206.     and the message data to one or more objects of a project
  1207.     which share the specified ID. By specifying an ID of NULL,
  1208.     you can send a message to the project itself.
  1209.  
  1210.    SEE ALSO
  1211.     Class descriptions, TR_SetAttribute, TR_GetAttribute()
  1212.  
  1213. triton.library/TR_SetAttribute                 triton.library/TR_SetAttribute
  1214.  
  1215.    NAME    
  1216.     TR_SetAttribute -- Sets an attribute of an object.
  1217.  
  1218.    SYNOPSIS
  1219.     TR_SetAttribute(Project, ID, Attribute, Value)
  1220.                     A0       D0  D1         D2
  1221.  
  1222.     VOID TR_SetAttribute(struct TR_Project *, ULONG,
  1223.                          ULONG, ULONG);
  1224.  
  1225.    FUNCTION
  1226.     Sets an attribute of a Triton object. Only attributes
  1227.     of objects with an ID can be changed. You can change the
  1228.     default attribute of an object by specifying NULL as
  1229.     the attribute to change. By specifying an ID of NULL, you
  1230.     can change those attributes of a Triton project which are
  1231.     marked with '(changeable)' in the TR_OpenProject docs.
  1232.  
  1233.    SEE ALSO
  1234.     Class descriptions, TR_GetAttribute(), TR_OpenProject()
  1235.  
  1236. triton.library/TR_UnlockProject               triton.library/TR_UnlockProject
  1237.  
  1238.    NAME    
  1239.     TR_UnlockProject -- Unlocks a Triton project.
  1240.  
  1241.    SYNOPSIS
  1242.     TR_UnlockProject(Project)
  1243.                      A0
  1244.  
  1245.     VOID TR_UnlockProject(struct TR_Project *);
  1246.  
  1247.    FUNCTION
  1248.     Unlocks a Triton project previously locked by
  1249.     TR_LockProject().
  1250.  
  1251.    SEE ALSO
  1252.     TR_LockProject()
  1253.  
  1254. triton.library/TR_UnlockScreen                 triton.library/TR_UnlockScreen
  1255.  
  1256.    NAME    
  1257.     TR_UnlockScreen -- Release a project's screen
  1258.  
  1259.    SYNOPSIS
  1260.     TR_UnlockScreen(Screen)
  1261.                     A0
  1262.  
  1263.     VOID TR_UnlockScreen(struct Screen *);
  1264.  
  1265.    FUNCTION
  1266.     Unlock a screen which has been locked by TR_LockScreen(). All
  1267.     locked screens must be unlocked! Locking/unlocking calls are
  1268.     nested.
  1269.  
  1270.    SEE ALSO
  1271.     TR_LockScreen()
  1272.  
  1273. triton.library/TR_Wait                                 triton.library/TR_Wait
  1274.  
  1275.    NAME    
  1276.     TR_Wait -- Waits for exec signals.
  1277.  
  1278.    SYNOPSIS
  1279.     Signals = TR_Wait(App, OtherBits)
  1280.             A1   D0
  1281.  
  1282.     ULONG TR_Wait(struct TR_App *, ULONG);
  1283.  
  1284.    FUNCTION
  1285.     Waits until a signal of the specified application
  1286.     or one of the other signal bits is set.
  1287.  
  1288.    RESULT
  1289.     Signals - The mask of set signals
  1290.  
  1291.    SEE ALSO
  1292.     TR_GetMsg(), TR_ReplyMsg()
  1293.  
  1294.